home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / misc / man35.lha / Man3.5 / DOCS / Deutsch / Man.DOK < prev    next >
Text File  |  1994-11-21  |  10KB  |  304 lines
  1. DOCUMENT Man
  2.  
  3. Man - © 1993,1994 by Markus Hillenbrand
  4. ---------------------------------------
  5.  
  6. Man ist ein Hilfsprogramm zum Anzeigen von Texten aus der Shell heraus.
  7. Dazu muß das Commodity aber schon geladen sein.
  8.  
  9.  
  10. 1. Systemvoraussetzungen
  11. ~~~~~~~~~~~~~~~~~~~~~~~~
  12.  
  13. Benötigt werden:  - asl.library         v37
  14.                   - intuition.library   v37
  15.                   - gadtools.library    v37
  16.                   - graphics.library    v37
  17.                   - dos.library         v37
  18.           - icon.library        v37 
  19.           - commodities.library v37 
  20.           - workbench.library   v37
  21.           - utility.library    v37
  22.           - reqtools.llibrary   v38    (c) by Nico François
  23.  
  24. Unterstützt wird: - locale.library      v38
  25.                   
  26. Empfohlen wird :  - eine Festplatte zur effizienten Nutzung von Hilftexten
  27.                   - "Multiview" von OS3.0 zum automatischen Anzeigen von
  28.                     .guide-Dateien
  29.           - "AmigaGuide" von OS2.0 als Ersatz für Multiview, wenn
  30.              kein OS3.0 vorhanden
  31.  
  32. 2. Installer
  33. ~~~~~~~~~~~~
  34.  
  35. Da das Programm Installer (© by Commodore) nicht frei kopiert werden darf
  36. und für die Installation nötig ist, müssen Sie dafür sorgen, daß dieses
  37. Programm im Befehlspfad Ihrer Shell liegt (z.B. C:, SYS:Utilities, ...).
  38. Sie finden den Installer auf Ihrer Workbench-Diskette von OS2.0, OS2.1
  39. bzw OS3.0.
  40.  
  41. Falls Ihre Version des Installers nicht mit der Installationsdatei von Man
  42. funktionieren sollte, gehen Sie wie folgt vor:
  43.  
  44.    1. Klicken Sie das Icon 'Man' an und legen Sie es im Verzeichnis 
  45.       'Workbench:WBStartup' ab.
  46.    2. Falls Sie über OS2.1 verfügen, kopieren Sie das Verzeichnis
  47.       'Catalogs' nach 'Locale:catalogs'.
  48.  
  49.  
  50. 3. ToolTypes
  51. ~~~~~~~~~~~~
  52.  
  53. Das Programm sucht beim Start nach den folgenden Tooltypes:
  54.  
  55. 3.1. CX_PRIORITY
  56. ~~~~~~~~~~~~~~~~
  57.  
  58. CX_PRIORITY=x, wobei x für einen Wert mit -128<x<127 steht. Dieser Wert
  59. gibt die Priorität des Commodities an. Voreingestellt ist 0.
  60.  
  61. 3.2. CX_POPKEY
  62. ~~~~~~~~~~~~~~
  63.  
  64. Hier kann man den Hotkey angeben, bei dem das Konfigurationsfenster ge-
  65. öffnet werden soll. Voreingestellt ist 'ctrl lalt m'.
  66.  
  67. 3.3. DONOTWAIT
  68. ~~~~~~~~~~~~~~
  69.  
  70. Dieser Eintrag ist nicht weiter von Bedeutung; er ist nur für den System-
  71. start wichtig.
  72.  
  73. 3.4. HOTKEY
  74. ~~~~~~~~~~~
  75.  
  76. Hier kann man den Hotkey angeben, bei dem der Text-Requester angezeigt
  77. werden soll. Voreigestellt ist 'ctrl help'.
  78.  
  79. 3.5. DATA
  80. ~~~~~~~~~
  81.  
  82. Der hier angegebene Dateiname ist für die Liste der Texte. Unter diesem 
  83. Namen werden die Text-Namen und ihre Pfade gespeichert. Voreingestellt
  84. ist 'Work:Man.LST'.
  85.  
  86. 3.6. GUIDE
  87. ~~~~~~~~~~
  88.  
  89. Das hier angegebene Programm wird benutzt, wenn eine Hypertext-Datei an-
  90. gezeigt werden soll.
  91.  
  92. 3.7. DVI
  93. ~~~~~~~~
  94.  
  95. Das hier angegebene Programm wird benutzt, wenn eine .dvi Datei angezeigt
  96. werden soll.
  97.  
  98. 3.8. UNIX
  99. ~~~~~~~~~
  100.  
  101. Das hier angegebene Programm wird benutzt, wenn eine UNIX man-page ange-
  102. zeigt werden soll.
  103.  
  104. 3.9. PROGRAM
  105. ~~~~~~~~~~~~
  106.  
  107. Das hier angegebene Programm wird benutzt, wenn ein normaler Hilftext an-
  108. gezeigt werden soll. Ein im Konfigurationsfenster eingegebenes Programm
  109. wird in den Tooltypes gespeichert, falls Sie im Konfigurationsfenster
  110. 'Speichern' gedrückt wird.
  111.  
  112. 3.10. REQX bzw REQY
  113. ~~~~~~~~~~~~~~~~~~~
  114.  
  115. Dies gibt die linke obere Ecke des Requesters an, der geöffnet wird, wenn
  116. man den Hotkey drückt oder 'man' in der Shell eingibt. Die Fensterposition 
  117. kann gespeichert werden, wenn man im Konfigurationsfenster 'Speichern'
  118. drückt.
  119.  
  120. 3.11. WINX bzw WINY
  121. ~~~~~~~~~~~~~~~~~~~
  122.  
  123. Dies gibt die linke obere Ecke des Konfigurationsfensters an. Die Fenster-
  124. position kann gespeichert werden, wenn man im Konfigurationsfenster 'Spei-
  125. chern' drückt.
  126.  
  127. 3.12. REQENTRIES
  128. ~~~~~~~~~~~~~~~~
  129.  
  130. Gibt die maximal zulässige Zahl von Einträgen an, die im Listview des
  131. Auswahlrequesters sichtbar sind. Falls diese Zahl zu groß sein sollte,
  132. so wird ein angemessener Wert errechnet, so daß noch alles auf den Screen
  133. paßt.
  134.  
  135. 4. Konfiguration
  136. ~~~~~~~~~~~~~~~~
  137.  
  138. Das Programm wird konfiguriert, indem man in der Shell "man -c" oder
  139. "man -config" eingibt. Danach erscheint ein Window, in dem verschiedene
  140. Einstellungen gemacht werden können.
  141.  
  142. Das Konfigurationsfenster wird aber auch geöffnet, indem man das Icon
  143. des Programmes zweimal anklickt oder aber (wenn das Commodity schon in-
  144. stalliert ist) bei Exchange (© by Comodore) das Gadget 'Fenster öffnen'
  145. anklickt.
  146.  
  147. Das geöffnete Fenster ist ein App-Window, d.h. daß Icons, die auf dieses
  148. Fenster gezogen werden, automatisch in die Liste im Listview-Gadget über-
  149. nommen werden.
  150.  
  151. Das Fenster ist in drei Sektionen unterteilt:
  152.  
  153. 4.1. Liste der Hilfs-Texte
  154. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  155.  
  156. In der oberen Hälfte des Fensters ist ein Listviewgadget, in dem alle zur
  157. Zeit aktuellen Texte angezeigt sind. Rechts daneben befinden sich einige 
  158. Gadgets, die folgendes bewirken:
  159.  
  160. 4.1.1. Zufügen|Add
  161. ~~~~~~~~~~~~~~~~~~
  162.  
  163. Klickt man dieses Gadgets an, so wird ein Requester geöffnet, mit dem man
  164. einen einzelnen Text hinzufügen kann.
  165.  
  166. 4.1.2. Löschen|Delete
  167. ~~~~~~~~~~~~~~~~~~~~~
  168.  
  169. Der im Listview-Gadget hervorgehobene Text wird (ohne Sicherheitsabfrage)
  170. aus der Liste gelöscht.
  171.  
  172. 4.1.3. Ändern|Edit
  173. ~~~~~~~~~~~~~~~~~~
  174.  
  175. Der im Listview-Gadget hervorgehobene Text kann mit diesem Gadget geändert
  176. werden (falls sich z.B. der Pfad geändert hat).
  177.  
  178. 4.1.4. Einlesen|ScanDir
  179. ~~~~~~~~~~~~~~~~~~~~~~~
  180.  
  181. Mit diesem Gadget kann ein ganzes Verzeichnis rekursiv durchsucht werden.
  182. Alle gefundenen Texte werden in das Listview-Gadget übernommen. Dieses
  183. Gadget ist bei der ersten Benutzung von Man besonders angebracht, da es
  184. viel Arbeit spart, z.B. den gesamten Pfad DH1: zu durchsuchen.
  185.  
  186. 4.1.5. LöschAll|DelAll
  187. ~~~~~~~~~~~~~~~~~~~~~~
  188.  
  189. Das soll heißen: Alles Löschen. Dieses Gadget bewirkt ein Löschen der ge-
  190. samten Liste. Aber keine Angst, es gibt eine Sicherheitsabfrage.
  191.  
  192.  
  193. 4.2. Anzeigeprogramm
  194. ~~~~~~~~~~~~~~~~~~~~
  195.  
  196. Im Gadget "Anzeigeprogramm" kann man einen Textanzeiger angeben, mit dem
  197. die Hilftexte angezeigt werden sollen. Das Gadget rechts neben dem String
  198. Gadget öffnet einen Requester, mit dem das Programm ausgewählt werden 
  199. kann.
  200.  
  201. 4.3. Standard-Gadgets
  202. ~~~~~~~~~~~~~~~~~~~~~
  203.  
  204. Mit 'Speichern' wird die aktuelle Konfiguration in gespeichert. Mit 'Verber-
  205. gen' wird das Fenster geschlossen und mit 'Beenden' wird das Commodity aus
  206. dem Speicher entfernt (eventuelle Änderungen werden NICHT gespeichert!!!)
  207.  
  208.  
  209. 5. Benutzung von der Shell aus
  210. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  211.  
  212. Um von der Shell aus einen Text anzeigen zu lassen, muß man diesen angeben.
  213. Dabei ist die Endung wegzulassen. "Man lha" sucht demnach in der Liste der
  214. Texte nach lha.doc, lha.dok, lha.man oder lha.guide oder ...
  215. Der Text wird dann mit dem voreingestellten Textanzeiger angezeigt.
  216. Gibt man "man -l" an, so wird eine Liste der Texte ausgegeben. Ruft man das
  217. Programm ohne Parameter auf, so wird eine Liste aller verfügbaren Hilfstexte
  218. angezeigt, in der man einen Text auswählen kann.
  219. Gibt man einen Pattern an (#?, ? usw.), so werden alle Texte, die zu diesem
  220. Pattern passen, aufgelistet. Paßt nur ein Text, so wird dieser gleich ange-
  221. zeigt.
  222. Mit "man -q" wird von der Shell aus das Kommodity verlassen.
  223.  
  224. 6. Lokalisierung unter WB2.1+
  225. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  226.  
  227. Ab der Workbench 2.1 kann das Programm lokalisiert werden, das heißt es
  228. kann leicht in andere Sprachen übersetzt werden. Dazu ist der C-Quelltext
  229. von MAN.catalog dem Programm beigefügt. Im Original werden nur deutsch,
  230. schwedisch und englisch unterstützt.
  231. Der C-Text kann jedoch erweitert werden und mit einem geeigneten Programm
  232. (z.B. MakeCAT - © by Paladin-Software) wieder in einen Katalog umgewandelt
  233. werden.
  234. Wenn Sie den Katalog in eine andere Sprache übersetzen, so wäre es sehr nett,
  235. wenn Sie mir den Quelltext dieses neuen Katalogs per e-mail zusenden würden,
  236. damit die Sprache in neueren Versionen von Man schon von vornherein unter-
  237. stützt wird!
  238.  
  239.  
  240. 7. Copyright und Anderes 
  241. ~~~~~~~~~~~~~~~~~~~~~~~~
  242.  
  243.    Copyright (C) 1993,94 by Markus Hillenbrand
  244.  
  245. Dieses Programm darf kopiert und weitergegeben werden solange die Copyright-
  246. Notiz und diese Dokumentation unverändert auf allen Kopien enthalten ist.
  247.  
  248. Es wird keine Garantie gegeben, daß das Programm 100%ig zuverlässig ist. 
  249. Sie benutzen dieses Programm auf eigene Gefahr. Der Autor kann auf *keinen*
  250. Fall für irgendwelche Schäden verantwortlich gemacht werden, die durch die 
  251. Anwendung dieses Programmes entstehen.
  252.  
  253. ACHTUNG: 
  254. Seit der Version 3.1 ist 'Man' CARDWARE, d.h. wenn Sie das Programm regel-
  255. mäßig benutzen, müssen Sie mir eine Postkarte mit einem Motiv aus Ihrer
  256. Heimat/Stadt/Ort/... zuschicken und ein paar Worte (in Ihrer Sprache ?)
  257. daraufschreiben.
  258.  
  259. Das Copyright liegt weiterhin bei Markus Hillenbrand. Dies bedeutet, daß 
  260. es von jedem kopiert werden darf, solange er nicht mehr als eine angemes-
  261. sene Kopiergebühr dafür verlangt. 
  262.  
  263. Dieses Paket darf in Public-Domain Sammlungen aufgenommen werden, in
  264. Mailboxsystemen oder auf FTP Servern abgelegt werden. Wenn Sie dieses
  265. Paket weitergeben wollen, dann *müssen* Sie die originale
  266. Distributionsdatei "man??.lha" benutzen.
  267.  
  268. Dieses Programm darf nicht ohne eine schriftliche Genehmigung des Autors in 
  269. kommerziellen Programmen benutzt werden.
  270.  
  271.  
  272. 8. Adresse des Autors
  273. ~~~~~~~~~~~~~~~~~~~~~
  274.  
  275. Hier ist meine Adresse (für Anregungen, Bug-Report, die Postkarte oder 
  276. Sonstiges):
  277.  
  278.                Markus Hillenbrand
  279.                Weserstraße 9
  280.                36124 Eichenzell-Löschenrod
  281.  
  282.                GERMANY
  283.  
  284.  
  285. oder e-mail:   m_hillen@informatik.uni-kl.de
  286.  
  287.  
  288. 9. Man-Pages
  289. ~~~~~~~~~~~~
  290.  
  291. Wenn Sie Interesse daran haben, eine Hilfs-Datei zu schreiben, so beachten
  292. Sie bitte die Hinweise in Verzeichnis "ManPages".
  293. Außerdem können Sie Lars Oloffson (e-mail: pt93lo@pt.hk-r.se) kontaktieren,
  294. um ein Archiv von Hilfs-Texten für die original AmigaDOS Befehle zu bekommen.
  295.  
  296.  
  297. 10. Danksagungen
  298. ~~~~~~~~~~~~~~~~
  299.  
  300. - Nico François für seine berühmte reqtools.library
  301. - Lars Oloffson für die Schwedisch-Lokalisierung
  302. - Marcus Flehmig fürs Beta-Testen
  303. - Stephan Sürken für sein Program 'Text2Guide'
  304.